/config/app/proxy/virtualServer//serviceTcp/persistSourceIp

Use

Use to enable session persistence, which lets the system send subsequent requests from a client to the same server to improve performance when the servers cache content or for applications that require requests from a client to be consistently sent to the same server.

You can configure session persistence the following ways:

  • Using the source IP–Uses the source IP address for session persistence. You can configure session persistence using the source IP. Use the idle-timeout option or the /config/app/proxy/virtualServer//serviceTcp/persistSourceIp/idleTimeout node to set when the session expires.
  • Using the SSL session ID–Uses the SSL session ID for session persistence. This is most useful for SSL over TCP traffic (TCP virtual IP without an SSL profile attached to the virtual IP). In this configuration, LineRate offloads the overhead of the SSL session establishment from the back-end server.
    • Use the idle-timeout option or the /config/app/proxy/virtualServer//serviceTcp/persistSslSessionId/idleTimeout node to set how long the session ID stays live in the cache.
    • Use the data-idle-timeout option to or the /config/app/proxy/virtualServer//serviceTcp/persistDataIdleTimeout node to set how long the system waits to receive enough data to determine if a persistence decision can be made. The system closes the connection after the time elapses to conserve resources.
    • You can use this configuration with HTTP over SSL and SSL over TCP traffic, but you do not offload any overhead from the back-end server.

Parameters

name: Name of virtual server object

Data Key

The data key contains the disabled (0) or enabled (1) status.

Note: When the default key is set to true, it means the object is set to its default. In this case, the system works as follows:

  • On a PUT operation, the system ignores the data key. (Applicable only to /config nodes.)
  • On a GET operation, the response only contains “default”: True and does not contain the data key.
  • If the object has a base, it inherits its setting from its base.

See [Setting Objects to Their Default](https://docs.lineratesystems.com/093Rel ease_2.5/250REST_API_Reference_Guide/000Getting_Started_with_the_REST_API/300U nderstanding_the_REST_Hierarchy#Setting_Objects_to_Their_Default_(Default_Key) ).

Data Type

uint32

Data Values

0 (disabled)

1 (enabled)

Default Data Value

0

An object uses the default data value when one of the following is true:

  • For objects without bases–When the object’s default key is true.
  • For objects with bases–When the object’s default key is true, and when the default key is true for all of the object’s bases.

Default Allowed

True

Request Methods

GET, PUT

Examples

GET

curl -b cookie.jar -k https://10.1.2.3:8443/lrs/api/v1.0/config/app/proxy/virt ualServer/vs-01/serviceTcp/persistSourceIp

GET Response

{"/config/app/proxy/virtualServer/vs-01/serviceTcp/persistSourceIp": {"default": True,
                                                                       "defaultAllowed": True,
                                                                       "deleteAllowed": False,
                                                                       "numChildren": 1,
                                                                       "type": "uint32"},
 "httpResponseCode": 200,
 "recurse": False,
 "requestPath": "/config/app/proxy/virtualServer/vs-01/serviceTcp/persistSourceIp"}

PUT

curl -b cookie.jar –data @data.json -k -H “Content-Type: application/json” -X PUT https://10.1.2.3:8443/lrs/api/v1.0/config/app/proxy/virtualServer/vs-01/se rviceTcp/persistSourceIp

PUT Response

{"httpResponseCode": 200,
  "requestPath": "/config/app/proxy/virtualServer/vs-01/serviceTcp/persistSourceIp",
  "recurse":false}
  1. /config/app/proxy/virtualServer//serviceTcp/persistSourceIp 1. Parameters 2. Data Key
    1. Data Type
    2. Data Values
    3. Default Data Value 3. Default Allowed 4. Request Methods 5. Related 6. Examples